3.4
Requesting Specific API Versions
Because of significant changes in the API introduced in a previous release, MWS possesses a versioned API. The api-version URL parameter can be used to change the requested API version for any call to MWS. The current valid API versions with their corresponding MWS versions are shown in the table below:
API Version |
MWS Version | Documentation | Notes |
---|---|---|---|
2 (deprecated) |
7.2.x | 7.2.x documentation on Moab Cloud HPC Suite – 7.2 Documentation |
As of the 8.0 release, API version 2 is officially deprecated and will be removed from MWS in a future release. |
3 | 8.0 | Contained within this document | -- |
latest | Latest | Contained within this document |
When the latest API version is requested, it resolves to the latest API version of MWS, such as api-version=3 for MWS 8.0. |

If no API version is specified, the request is rejected. An API version must be specified with every call in MWS.
Chapter 4: Resources and Resources Reference contain information for the latest API version. For documentation of previous API versions, see the table above.
Examples
GET https://localhost:8080/mws/rest/nodes?api-version=2 // Data returned uses API version 2 GET https://localhost:8080/mws/rest/nodes?api-version=latest // Data returned uses API version 3